Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Tracks

InsertEmptyTrackSegment

The InsertEmptyTrackSegment function adds an empty segment to a track. You specify the starting time and duration of the empty segment to be added. These times must be expressed in the movie's time scale. This function then inserts the appropriate amount of empty time into the track. The exact meaning of the term empty time depends upon the type of track. For example, empty time in a sound track is silent.

pascal OSErr InsertEmptyTrackSegment (Track dstTrack, 
                                       TimeValue dstIn,
                                       TimeValue dstDuration);

dstTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

dstIn

Contains a time value specifying where the segment is to be inserted. This time value must be expressed in the time scale of the movie that contains the destination track.

dstDuration

Contains a time value that specifies the duration of the segment to be added. This time value must be expressed in the time scale of the movie that contains the destination track.

DESCRIPTION

Note that you cannot add empty space to the end of a movie or to the end of a track. If you try to add an empty segment beyond the end of a track, this function does not add the empty segment and returns a result code of invalidTime.

ERROR CODES

invalidTrack	-2009	This track is corrupted or invalid
invalidDuration	-2014	This duration value is invalid
invalidTime	-2015	This time value is invalid

Memory Manager errors